Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 5 - Printing Functions for Message Overrides / Printing Functions Reference

Functions / Storing and Accessing Desktop Printer Data

GXFetchDTPData

You can use the GXFetchDTPData function to access data from the desktop printer.

OSErr GXFetchDTPData (Str31 dtpName, OSType theType,
                      short theID, Handle *theData);

dtpName

The name of the desktop printer from which to retrieve the data.

theType

The type in which you are interested.

theID

The ID in which you are interested.

theData

A pointer to a handle that, on return, references the data.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The GXFetchDTPData function accesses data from the desktop printer. You can call this function if you need to examine the data. GXFetchDTPData accesses the data and returns a handle to it in the theData parameter.

The handle that you receive back from this function has been detached, which means that you must call the DisposeHandle function on it when you have finished with it.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

You can find an example of using the GXFetchDTPData function in Listing 3-9 on page 3-31 in the chapter "Printer Drivers."

The DisposeHandle function is described in Inside Macintosh: Memory.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help